home *** CD-ROM | disk | FTP | other *** search
/ Amiga Collections: Franz PD / Franz PD Disk #265 (1993)(Rhein-Sieg-Soft).zip / Franz PD Disk #265 (1993)(Rhein-Sieg-Soft).adf / AKCC_V2.2.0.LHA / AKCC_Docs / AKCC_ENG.doc < prev    next >
Text File  |  1993-05-30  |  14KB  |  534 lines
  1.  
  2.                 AKCC V2.2.0
  3.  
  4.                - SHAREWARE -
  5.  
  6.          (c) 1990-93 by Andreas R. Kleinert. All rights reserved.
  7.  
  8.           This program was written under OS V3.00 and is therefore
  9.           fully compatible. It needs OS >= V1.2.
  10.           This program needs 'akcc_gen0.library' V36+ (in "LIBS:").
  11.  
  12.           Release Date : 30.05.1993
  13.  
  14.  
  15.     Copyright :
  16.     ===========
  17.  
  18.     The program AKCC V2.2.0 and its documentation files are
  19.     (C)opyright 1990-93 by Andreas R. Kleinert. All rights reserved.
  20.  
  21.     The right of using this program is granted to you by paying the
  22.     SHAREWARE-fee of 15,00 DM (10 $) to the author.
  23.  
  24.  
  25.     Disclaimer :
  26.     ============
  27.  
  28.     The author takes no responsibility for any results of the use of this
  29.     program.
  30.     This software is provided "AS IS" and there is no warranty of any kind,
  31.     so that you use this software at your own risk.
  32.  
  33.  
  34.     Rights :
  35.     ========
  36.  
  37.     Registered users - users, which paid the SHAREWARE-fee already -
  38.     have the possibility to send the author an empty disk and enough
  39.     postage money to receive the newest version of the program.
  40.  
  41.     These users also may receive later versions for enough postage
  42.     money and an empty disk, but only as long as the author thinks
  43.     that he's able to provide this service, and as long as the development
  44.     of the program is continued and no changes have taken place in the
  45.     legal status of the program (Freeware, commercial, ...).
  46.  
  47.     The SHAREWARE-fee only corresponds to the current version owned by
  48.     the user. All the rest are ADDITIONAL and VOLUNTARY services of
  49.     the author.
  50.  
  51.  
  52.     Disclaimer :
  53.     ============
  54.  
  55.     Der Autor übernimmt keine Verantwortung für irgendeine Art von Auswir-
  56.     kungen, die durch die Nutzung dieses Programmes entstehen.
  57.     Diese Software wird zur Verfügung gestellt "WIE SIE IST" und es wird
  58.     keine Garantie irgendeiner Art übernommen, so daß Sie diese Software
  59.     auf eigenes Risiko nutzen.
  60.  
  61.  
  62.     Distribution :
  63.     ==============
  64.  
  65.     The program AKCC V2.2.0 is freely distributable (SHAREWARE).
  66.     You may copy it, if the copyright notice is left intact and
  67.     all of its parts are included in the distribution.
  68.     This program must not be included in commercial packages or commercial
  69.     program collections without my written permission.
  70.     This program must not be sold in any way, but it is allowed to take
  71.     a nominal fee including the costs for copying.
  72.  
  73.     This program may be put on public domain disks or included in public
  74.     domain disk libraries.
  75.     Special permission hereby goes to Fred Fish's AmigaLib-Disks and
  76.     the german series TAIFUN, FRANZ, TIME, GPD and Amiga Szene.
  77.  
  78.     This program may also be distributed via electronic mail and may be
  79.     put into mailboxes as long as the redistribution conditions are
  80.     respected in all points.
  81.  
  82.     By using or distributing this program you automatically agree to
  83.     all of the above conditions and terms.
  84.  
  85.  
  86.     Function :
  87.     ==========
  88.  
  89.     AKCC V2.2.0 is a packet of CLI-/Shell-Commands for the Amiga, which
  90.     is intended to make working with the AMIGA, especially for experienced
  91.     users and programmers, but also beginners, somewhat easier.
  92.     AKCC is intended to be additionally used with other existing CLI-/Shell-
  93.     Packets (e.g. with those from ARP or Commodore).
  94.  
  95.     There are as well programs which just replace similar ones, as well as
  96.     programs, which are completely new.
  97.  
  98.  
  99.     Installation :
  100.     ==============
  101.  
  102.     Version A :
  103.  
  104.       1. Use the special Installation program.
  105.      (If there do appear problems, which should not happen, use the
  106.       'Version B' method ...)
  107.  
  108.     Version B :
  109.  
  110.       1. Copy the (yet) 35 'AKCC' commands into the 'C'-Directory on your
  111.      System- or on any other disk.
  112.       2. Copy the actual version of the 'akcc_gen0.library' (V36+) into the
  113.      'LIBS'-Directory on your System- or on any other disk.
  114.  
  115.     Version C (if you've got a lack of disk-space ...)
  116.  
  117.       1. Just copy the part of the (yet) 35 'AKCC' commands THAT YOU NEED
  118.      into the 'C'-Directory on your System- or any other disk.
  119.       2. Copy the actual version of the 'akcc_gen0.library' (V36+) into the
  120.      'LIBS'-Directory on your System- or on any other disk.
  121.  
  122.     Also :
  123.  
  124.       ... create (please) the logical Devices 'T:', 'ENV:' and 'CLIPS:'
  125.       (e.g. as follows) !!!
  126.  
  127.         MakeDir RAD:t             ; In the startup-sequence :
  128.         MakeDir RAD:env          ; Set 'FailAt' on a higher level,
  129.         MakeDir RAD:clipboards         ; if using 'RAD:', because
  130.  
  131.         Assign T: RAD:t          ; 'MakeDir' will produce errors
  132.         Assign ENV: RAD:env         ; after a reset.
  133.         Assign ENV: RAD:clipboards   ; ('RAD:' is recoverable, as you
  134.                          ; know ...)
  135.  
  136.       For creating 'ENV:' you may (and should) use the AKCC-Command
  137.       'EnvAct' instead (if possible) !
  138.  
  139.       ... please increase the stack size on a higher level !
  140.       It's useful to work with a stack size of at least 30000 Bytes,
  141.       which is useful for all programs, which work recursively
  142.       (not only Compilers do so !!!).
  143.  
  144.     All of the commands can be made memory-resident with the CLI-Command
  145.     'Resident'.
  146.  
  147.  
  148.     Correspondence :
  149.     ================
  150.  
  151.     If you like, you may send me some money. Perhaps this will motivate me
  152.     to continue programming such programs or just making updates of
  153.     this one. Send bug-reports, money or whatever to :
  154.  
  155.        Andreas R. Kleinert,
  156.        Grube Hohe Grethe 23,
  157.        W-5900 Siegen 1,
  158.        Germany.
  159.  
  160.  
  161.     Usage :
  162.     =======
  163.  
  164.     Each single 'AKCC'-Command prints out a short desrciption of itself,
  165.     when it is started with a single '?' as its only parameter.
  166.     This description always looks like this :
  167.  
  168.           'USAGE : x <x> <x> [...]'
  169.  
  170.     The same thing happens, if a command was used wrong, but only if it has
  171.     not been used TOO WRONG ...
  172.  
  173.  
  174.     Command Summary :
  175.     =================
  176.  
  177.     AboutCLI                 AD     *
  178.     CheckExec                 Comment    *
  179.     DateAct                 Display
  180.     DosRequest                 Duplic    *
  181.     EnvAct                 ExecDevs
  182.     ExecIRupts                 ExecLibs    *
  183.     ExecMem                 ExecPorts
  184.     ExecRes                 ExecSems
  185.     ExecTasks                 ExtShow    *
  186.     FullPath                 HunkShow
  187.     KAssign    *             Kill    *
  188.     KillTask   *             KInfo
  189.     KScroller                 LED
  190.     Move       *             NewDir
  191.     NewName                 PrefSet
  192.     PriSet     *             ProSet    *
  193.     Show       *             Texter
  194.     WinAct
  195.  
  196.     Commands marked with a '*' support WildCards ('*'/'?'/'#?') and/or the
  197.     recursive method of working on directories (option '-a').
  198.  
  199.     Under OS V2.04+ the normal DOS-WildCards are ADDITIONALLY
  200.     supported (inclusive WildStar, e.g. "(Hello#?|World*)" ).
  201.  
  202.  
  203.     A more detailed ListUp :
  204.  
  205.  
  206.       AboutCLI
  207.              -> (gives information about some preferences of the
  208.              (current) CLI : Stacksize, Prompt, Path, ...)
  209.  
  210.       AD
  211.              -> (changes the current directory. WildCards and Backward-
  212.              References possible.)
  213.  
  214.       CheckExec
  215.  
  216.              -> (shows some values of the 'ExecBase' and checks some
  217.              vectors to avoid viruses.
  218.              Is also able to show Boot-Blocks.
  219.              Printer output possible.)
  220.  
  221.       Comment
  222.              -> (adds remarks to a file. WildCards.)
  223.  
  224.       DateAct
  225.              -> (shows or sets the actual system-time and -date.
  226.              Is also able to read/write the Realtime-Clock
  227.              MSM 6242 B - e.g. inside the Amiga 500 Plus.)
  228.  
  229.       Display
  230.              -> (displays the content of a file on the Screen or
  231.              a (virtual) device (e.g. PRT:, CON:, SER:, ...),
  232.              or into an other file. Supports octal and hexadecimal
  233.              printing and source-code generation.)
  234.       Duplic
  235.              -> (copies files/dirs.)
  236.  
  237.       EnvAct
  238.              -> (is able to manage all affairs with environment-
  239.              variables in an easy and quick way.)
  240.  
  241.       ExecLibs
  242.              -> (informs about all resident/deletes/loads libraries.)
  243.  
  244.       ExecMem
  245.              -> (shows free memory.
  246.              The special : Is able to write the result into an
  247.              environment variable !!!)
  248.  
  249.       ExecSems
  250.              -> (informs about all resident semaphores.)
  251.  
  252.       ExecRes
  253.              -> (informs about all resident resources.)
  254.  
  255.       ExecIRupts
  256.              -> (informs about all resident interrupts.)
  257.  
  258.       ExecDevs
  259.              -> (informs about all resident devices.)
  260.  
  261.       ExecPorts
  262.              -> (informs about all resident ports.)
  263.  
  264.       ExecTasks
  265.              -> (informs about all active tasks.)
  266.  
  267.       ExtShow
  268.              -> (shows a directory, protection bits, date and
  269.              comment.
  270.              With special functions under OS V2.04.)
  271.  
  272.       FullPath
  273.              -> (Sets a completely new list of paths, which have
  274.              to be searched for commands.
  275.              Parameter is the name of a file, which contains
  276.              this list.
  277.              As a result of this, the order, in which the paths
  278.              have to searched is exactly defined.
  279.              Also single paths may be added or removed.)
  280.  
  281.       HunkShow
  282.              -> (shows the HUNKS of a program or object-file
  283.              and recognizes IFF-files of all kinds, also
  284.              other kinds of files.)
  285.  
  286.       KAssign
  287.              -> (manages assignments.
  288.              With special functions under OS V2.04.)
  289.  
  290.       Kill
  291.              -> (deletes files/dirs.)
  292.  
  293.       KillTask
  294.              -> (deletes one (or many) task(s) from the system's lists.
  295.              With WildCard-Support !!!.)
  296.  
  297.       KInfo
  298.              -> (gives Information of all mounted Volumes, e.g. Disks
  299.              or RAM-Disks.)
  300.  
  301.       LED
  302.              -> (turns the Audio-Filter (PowerLED) on or off.)
  303.  
  304.       Move
  305.              -> ('moves' files/dir from one device/dir to an other.
  306.              Copies the Source, then deletes it => combination
  307.              of 'Kill' and 'Duplic'.)
  308.  
  309.       NewName
  310.              -> (renames files/dirs.)
  311.  
  312.       NewDir
  313.              -> (creates a new directory or a complete new path :
  314.              e.g. 'df0:Texts/Letters/Private'.)
  315.  
  316.       ProSet
  317.              -> (sets new protection bits for a file
  318.              [from : hsparwed].)
  319.  
  320.       PriSet
  321.              -> (changes the priority of a task/process via name-
  322.              reference.
  323.              WildCards !!!.)
  324.  
  325.       PrefSet
  326.              -> (allows to change some of the system's preferences
  327.              [e.g. key repeat delay and speed], either via a sim-
  328.              ple 'menu' or via command line arguments.)
  329.       Show
  330.              -> (shows a directory.)
  331.  
  332.       Texter
  333.              -> (prints out a text on the screen OR on a parallel
  334.              printer.
  335.  
  336.              options : normal, bold, underlined, italic,
  337.                    reverse, free lines)
  338.  
  339.              All the styles and more things are to control via
  340.              codes like those in 'C' (e.g. '\I', '\B', '\C=0,1')
  341.  
  342.              Uses for parallel printing 'PRT:' or, if 'PRT:'
  343.              not available, 'PAR:'.)
  344.  
  345.       WinAct
  346.              -> (sizes the active window to PAL-, NTSC- or the
  347.              biggest possible size, or brings it just to a
  348.              wished X/Y-size (everything possible).
  349.              Also can move the window into the left, top corner
  350.              of the screen or give it a new title.)
  351.  
  352.  
  353.     Additional Information :
  354.     ========================
  355.  
  356.        - EnvAct
  357.  
  358.      ---> SHOULD be called in the Startup-Sequence / User-StartUp.
  359.           e.g. as follows :
  360.  
  361.            EnvAct INIT RAM:
  362.  
  363.            Creates the directory 'RAM:env', assigns it to 'ENV:', and
  364.            the environment variables 'AKCC' and 'AKCC-LIB'.
  365.  
  366.        - NewDir
  367.  
  368.      ---> NewDir also creates complete paths (recursive), so that con-
  369.           structions like 'RAM:tmp/comp/txt/1' etc. are also legal !
  370.           One command suffices !
  371.  
  372.        - Texter
  373.  
  374.      ---> All the styles are combineable (for the printer as well as for
  375.           the screen).
  376.  
  377.        - PrefSet
  378.  
  379.      ---> - Be careful by changing the 'KEY...'-values !!!
  380.           - Manipulations on the TOPAZ-charset only becomes important, if
  381.         a new window is opened.
  382.  
  383.        - KillTask
  384.  
  385.      ---> Be careful by killing any tasks/processes (especially
  386.           System-Tasks).
  387.  
  388.  
  389.     Known Bugs :
  390.     ============
  391.  
  392.     - 'AD'    :
  393.  
  394.         Some Shells, like the OS-2.04-Shell, or the 'WShell', which
  395.         shows the current directory in the title bar of the window or
  396.         in the prompt of the command-line, don't examine the changes
  397.         made by 'AD'.
  398.          -> Fixing :
  399.              WShell :
  400.                     Don't use the shell, live with it, or
  401.                     turn its special function off.
  402.              OS V2.04 :
  403.                     Well, in this OS-Version the Command 'CD'
  404.                     is resident (in ROM), so you don't need
  405.                     AKCC's 'AD'.
  406.  
  407.     - 'CheckExec FORMAT' :
  408.  
  409.         Does not seem to be fully free of bugs yet. Sorry !
  410.  
  411.  
  412.     (For KNOWN BUGS of the 'akcc_gen0.library', see 'akcc_gen0.library.doc' !)
  413.  
  414.  
  415.     History :
  416.     =========
  417.  
  418.      V2.2.0 : (30.05.1993)
  419.      --------
  420.  
  421.       - improved some commands :
  422.     AboutCLI, ExecLibs, ExecDevs, ExecRes, ExecTasks, HunkShow
  423.  
  424.  
  425.      V2.1.2 :
  426.      --------
  427.  
  428.       - improved KillTask (BREAK-Option) and HunkShow.
  429.       - Bug-fixes in the akcc_gen0.library (see its doc-file)
  430.     [ some releases ]
  431.  
  432.  
  433.      V2.1.1 :
  434.      --------
  435.  
  436.       - use of SAS/C V6.00
  437.       - sometimes GREAT code-reduction
  438.       - many enhancements and bug-fixes
  439.     (ExecDevs, ExecSems, CheckExec, ...)
  440.  
  441.  
  442.      V2.0.1 :
  443.      --------
  444.  
  445.       - Bugs fixed :
  446.  
  447.      - FullPath :
  448.  
  449.         - Now also under OS V2.04 runable bug-free
  450.           (because of bug-fix in "akcc_gen0.library).
  451.  
  452.       - especially improved commands :
  453.  
  454.      - ExecDevs  : Now same options as ExecLibs.
  455.      - AboutCLI  : "Optical" improvements.
  456.  
  457.       - AND MORE IMPROVEMENTS
  458.  
  459.  
  460.      V1.7.1 :
  461.      --------
  462.  
  463.       - Bugs fixed :
  464.  
  465.      - ExecRes :
  466.  
  467.         - Known bug hopefully now fixed.
  468.  
  469.      - HunkShow :
  470.  
  471.         - many bugs have been fixed.
  472.  
  473.       - connected (or 'integrated') commands :
  474.  
  475.        Integrated program         Former single programs
  476.  
  477.        KAssign             (added KAssign-2)
  478.        ExtShow             (added ExtShow-2)
  479.  
  480.       - especially improved commands :
  481.  
  482.      - Display   : Now also creates Assembler- or C-Source out of a File.
  483.                ("dc.b"-field / BYTE-Array).
  484.  
  485.      - HunkShow  : Now also recognizes "RIFF-????"-Files.
  486.  
  487.      - CheckExec : - Is now also able to format disks.
  488.                - SAFE check WHICH DiskDrive !
  489.  
  490.       - AND MANY MORE IMPROVEMENTS
  491.  
  492.  
  493.      V1.6.2 :
  494.      --------
  495.  
  496.       - Use of "akcc_gen0.library" V36.7 with more functions.
  497.  
  498.       - Bugs fixed :
  499.  
  500.      - CheckExec,DateAct :
  501.  
  502.         - ExtIO-Structure was not delocated.
  503.  
  504.      - FullPath :
  505.  
  506.         - Heavy bug fixed.
  507.  
  508.       - especially improved commands :
  509.  
  510.      - AboutCLI, CheckExec, ... :
  511.  
  512.         - Output has been improved (less routine-calls).
  513.  
  514.      - Exec... :
  515.  
  516.         - improved Text-Formatting.
  517.           (ExecRes : bug fixed.)
  518.  
  519.      - HunkShow  : Recognizes much more File-Types.
  520.                The routines for recognition have also been improved.
  521.  
  522.  
  523.     [ Version-History of versions before V1.6.2 is no longer
  524.       included. ]
  525.  
  526.  
  527.     Copyrights :
  528.     ============
  529.  
  530.     Some of the mentioned names or products above may be copyrighted by
  531.     companies or trademarks of companies.
  532.  
  533.  
  534.